home *** CD-ROM | disk | FTP | other *** search
/ Your Choice 3 / Your Choice Software Collection 3.iso / sndtools / modmnu21 / mm.doc < prev    next >
Text File  |  1994-08-23  |  20KB  |  474 lines
  1.      │                                                                  │
  2.      │         ┌█████▄ ┌▄███▄ ┌███▄  ┌█████▄ ┌████ ┌███▄ ┌██▐█ TM       │
  3.      │         │██▐█▐█ │██▌██ │██▐█  │██▐█▐█ │██   │██▐█ │██▐█          │
  4.     M│         │██▐█▐█ │██▌██ │██▐█  │██▐█▐█ │███▌ │██▐█ │██▐█          │M
  5.      │         │██▐█▐█ │██▌██ │██▐█  │██▐█▐█ │██   │██▐█ │██▐█          │
  6.     o│         │██▐█▐█ │██▌██ │██▐█  │██▐█▐█ │██   │██▐█ │██▐█          │o
  7.      │         │██▐█▐█ │██▌██ │██▐█  │██▐█▐█ │██   │██▐█ │██▐█          │
  8.     d│         │██▐█▐█ └┐███┘ │███▀  │██▐█▐█ │████ │██▐█ │████          │d
  9.      │         └─┘─┘─┘  └──┘  └──┘   └─┘─┘─┘ └───┘ └─┘─┘ └───┘(R)       │
  10.     M│                                                                  │M
  11.      │                                                                  │
  12.     e│                                                                  │e
  13.      │     ModMenu (R) is a registered trademark of Apex Software.      │
  14.     n│                                                                  │n
  15.      │    (C) Copyright 1994,95 Apex Software.  All rights reserved.    │
  16.     u│                                                                  │u
  17.      │           Shareware (unregistered) Evaluation Copy.              │
  18.      │                                                                  │
  19.      │          Version 2.1, released on August 23rd, 1994.             │
  20.      │                                                                  │
  21.      │                  -< M I N O R  U P D A T E >-                    │
  22.      │                                                                  │
  23.      │                                                                  │
  24.  
  25.  
  26. INTRODUCTION:
  27. ~~~~~~~~~~~~~
  28. ModMenu is a program that lets you choose from a list of available modules
  29. in a directory to play with a .MOD player.  It can be used as a shell to any
  30. player of your choice.  The flexibility and power of this program are in no
  31. way forfeited because of its compact size.  Great efforts have been put into
  32. this program to keep it as small, simple, and easy to use as possible.  It
  33. offers all the options of other, much bigger, rivals.  There is work in 
  34. progress to enhance ModMenu with several other options to suit the needs of
  35. users, and any and all suggestions from you are welcome and will be taken
  36. into consideration for future developments.
  37.  
  38.  
  39.  
  40. FEATURES:
  41. ~~~~~~~~~
  42.         ∞  Tag/Untag all or individual files.
  43.         ∞  Configurable player, use ANY player you wish.
  44.         ∞  Will pass parameters to your player.
  45. *NEW*   ∞  Random mode to randomly play tagged modules.
  46. *NEW*   ∞  Loop mode to play modules continously.
  47. *NEW*   ∞  Control panel between multiple playing of songs.
  48.         ∞  Simple yet extremely flexible, powerful, and user friendly.
  49.         ∞  VERY compact, the executable is only 33k!
  50.  
  51.  
  52.  
  53. DISCLAIMER:  You are hereby informed that:
  54. ~~~~~~~~~~~
  55.  
  56. (A) 
  57.  
  58. This software (ModMenu) is provided AS-IS, use it at your own risk.
  59.  
  60. (B)
  61.  
  62. Apex Software disclaims ALL warranties relating to this software, whether 
  63. expressed or implied, including but not limited to any implied warranties of 
  64. merchantability and fitness for a particular purpose, and ALL such warranties 
  65. are expressly and specifically disclaimed.  Neither Apex Software nor anyone 
  66. else who has been involved in the creation, production, or delivery of this 
  67. software shall be liable for any indirect, consequential, or incidental 
  68. damages arising out of the use or inability to use such software even if Apex
  69. Software has been advised of the possibility of such damages or claims.  In NO
  70. event shall Apex Software be held responsible for the liability of this program
  71. regardless of the nature of the claim.  You, the user of this program, agree
  72. to bear all risks regarding the quality and performance of the software
  73. (ModMenu) by using it.
  74.  
  75. (C)
  76.  
  77. This warranty gives you specific legal rights, and you may or may not have
  78. other rights which vary from state to state.  Some states do not allow the
  79. exclusion of implied warranties or exclusion of liability for incidental or
  80. consequential damages, so the above may or may not apply to you.
  81.  
  82.  
  83.  
  84. MISCELLANEOUS & TRADEMARKS:
  85. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  86.     ■ All monetary units mentioned are in U.S. currency.
  87.  
  88.     ■ Apex, the Apex logo, ModMenu, and the ModMenu logo are registered
  89.       trademarks of Apex Software. Copyright 1994,95. All rights reserved.
  90.     
  91.     ■ ModMenu has a built-in security check to protect against tampering
  92.       and/or viruses.  If your copy of ModMenu has been altered or infected
  93.       with a virus, the program WILL NOT run and will alert you with a
  94.       message.  Please do not distribute your copy if it is tampered. Contact
  95.       us for an original, unaltered copy.
  96.  
  97.     ■ All brand and product names mentioned in this document are registered
  98.       trademarks of their respective owners or companies.
  99.  
  100.  
  101.  
  102. SYSTEM REQUIREMENTS:
  103. ~~~~~~~~~~~~~~~~~~~~
  104.     
  105.     ∙ A module, or .MOD, player such as DMP or WOWII and some .MOD files!
  106.  
  107.     ∙ A 286 or better with 1 meg RAM, VGA card and monitor.
  108.  
  109.       NOTE:  A 386 or better with 2+ meg RAM is strongly recommended
  110.              for optimum performance, especially if your module player
  111.              needs a lot of memory.
  112.  
  113.     ∙ DOS version 3.0 or later.
  114.  
  115.  
  116.  
  117. TESTING OF MODMENU:      ModMenu was tested on...
  118. ~~~~~~~~~~~~~~~~~~~
  119.         
  120.        ≡ A 286/12 MHZ with 1 MB RAM, SVGA monitor, and DOS v5.0.
  121.  
  122.        ≡ A 386/33 MHZ with 4 MB RAM, SVGA monitor, and DOS v6.2.
  123.  
  124.                       ModMenu was NEVER tested on...
  125.  
  126.        ≡ Anything slower than a 286/12 MHZ or faster than a 386/33 MHZ.
  127.  
  128.        ≡ A system with a monochrome display.
  129.  
  130. NOTES:
  131. ^^^^^^
  132. ModMenu performed exceptionally well on the 286/12 MHZ with 1 MB RAM.  The
  133. time it took to load up 55 modules was only about 2.3 seconds! That's
  134. approximately .041 seconds per module...on a 286!
  135.  
  136. Feel free to test ModMenu on your system and report anything unusual to the
  137. author. Although extensive testing has been performed on ModMenu for any bugs,
  138. we do not guarantee that it doesn't contain any.  If you find a bug, please
  139. let me know.
  140.  
  141.  
  142.  
  143. LIMITATIONS IN THE UNREGISTERED, SHAREWARE VERSION:
  144. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  145.  
  146.     ∙ ModMenu will only load 35 modules.
  147.  
  148.     ∙ There is a delay at the beginning of the program.
  149.       (After the Apex (R) Software logo)
  150.  
  151.     ∙ Annoying "Unregistered" messages and screens.
  152.     
  153.  
  154.  
  155. REGISTRATION FEE:
  156. ~~~~~~~~~~~~~~~~~
  157. The basic fee for this program is $10.00 (ten dollars).  For a list of
  158. what registered users will get, please see section "WHAT REGISTERED
  159. USERS GET" below.
  160.  
  161. Registered users will receive ALL minor upgrades free of charge.
  162. One (1) major upgrade will be offered free of charge; however,
  163. a fee of $5.00 (five dollars) is charged for any subsequent major
  164. upgrade requests.
  165.  
  166. To register ModMenu, please print the included REGISTER.FRM and
  167. fill it out legibly.  Or, if you wish, you can fill it out with
  168. a text editor first before printing.  If you would like custom
  169. colors, please also fill out COLORS.FRM and send it along with
  170. REGISTER.FRM.
  171.  
  172.  
  173.  
  174. WHAT REGISTERED USERS GET (AND UNREGISTERED USERS DON'T GET):
  175. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  176.  
  177.     ∙ ModMenu will load up to a minimum of 1,500 modules.
  178.  
  179.     ∙ Absolutely no "Unregistered" delays whatsoever.
  180.  
  181.     ∙ Removal of all "Unregistered" messages and screens.
  182.  
  183.     ∙ Personalized with a "Registered to:" message.
  184.  
  185.     ∙ All minor upgrades and one (1) major upgrade are free of charge.
  186.  
  187.     ∙ Custom color configuration is available, simply fill out COLORS.FRM
  188.       along with REGISTER.FRM and send them to us.
  189.       
  190.     ∙ If you wish, we can fill the registered program disk with modules.
  191.       We will put as many modules as possible in this disk, and we are
  192.       not responsible if you already have one or more of the ones we
  193.       send.
  194.  
  195.  
  196.  
  197. USING MODMENU:
  198. ~~~~~~~~~~~~~~
  199. ModMenu was designed with simplicity and ease of usage in mind, so there
  200. isn't much under this section.
  201.  
  202.  
  203. GETTING STARTED AND THE CONFIGURATION WINDOW:
  204. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  205.     
  206.     ModMenu is started by typing "MM" at the DOS prompt.  The first time
  207. you run ModMenu, you will be prompted for the description of the module
  208. player that you would like to use, the path to the executable of the module
  209. player, and finally the path to your .MOD directory.  Once you have entered
  210. a value, press Enter to move on to the next field.  The program comes with
  211. sample default values for tutorial purposes.  The first time you run the
  212. program, the configuration menu will look something like this:
  213.  
  214. ┌─────────────────────────────────────┐┌─────────────────────────────────────┐
  215. │            ModMenu v2.1             ││  Using: Dual Module Player v3.0     │
  216. │  Evaluation Copy, Please Register!  ││ExePath: C:\MUSIC\DMP.EXE /L         │
  217. │    Module: 1 of 35     Tagged: 0    ││ModPath: C:\MUSIC\MOD\               │
  218. └─────────────────────────────────────┘└─────────────────────────────────────┘
  219. ┌───────────────╔═══════════════════════════════════════════╗────────────────┐
  220. │ ┌─────────────║                                           ║──────────────┐ │
  221. │ │ 1993.MOD    ║           ModMenu Configuration           ║ght 1         │ │
  222. │ │ 4BLOUNDS.MOD║                                           ║rk            │ │
  223. │ │ ACOUSTIC.MOD║     Using: Dual Module Player v3.0        ║              │ │
  224. │ │ AIR.MOD     ║                                           ║an Dream      │ │
  225. │ │ AIRWOLF.MOD ║   ExePath: C:\MUSIC\DMP.EXE /L            ║usters II     │ │
  226. │ │ ALI.MOD     ║                                           ║e There       │ │
  227. │ │ ANDANTE.MOD ║   ModPath: C:\MUSIC\MOD\                  ║ Paa Klisje   │ │
  228. │ │ AXELF.MOD   ║                                           ║Swing It      │ │
  229. │ │ BATMEAT.MOD ║     Delay: 5                              ║              │ │
  230. │ │ CHINDUDE.MOD║                                           ║Potion?       │ │
  231. │ │ DON.MOD     ║                                           ║ Servant      │ │
  232. │ │ DREAMS.MOD  ╚═══════════════════════════════════════════╝ngnekyuteh Jys│ │
  233. │ │ ELYSIUM.MOD   Elysium             ││ SAD-SONG.MOD  Sad Song            │ │
  234. │ │ ERASURE.MOD   Hcs Erasure Mix     ││ SINISTR.MOD   Sinister Sky        │ │
  235. │ │ EYETIGER.MOD  Eye Of The Tiger    ││ SOMEBODY.MOD  Somebody            │ │
  236. │ └──────PgDn,PgUp,,,Home,End───────┘└─────────SPACE to Tag/Untag────────┘ │
  237. └────────────────────────────────────────────────────────────────────────────┘
  238.  Find, Loop, Randomize, Exit, Tag/Untag All, Configure - [ ] Loop  [ ] Random
  239. -----------------------------------------------------------------------------
  240.     
  241.     At the "Using" prompt, enter the description of the module player that
  242. you would like to use, NOT the executable (EXE) file.  For example, if you
  243. are using DMP v3.0, you might put something like "Dual Module Player v3.0"
  244. at this prompt.  You can put anything you want here, as long as it is 28
  245. characters or less.
  246.  
  247.     At the "ExePath" prompt, enter the path and executable file name of the
  248. module player that you indicated in the "Using" prompt.  For example, if
  249. you are using DMP v3.0 and it is located in a directory called "MUSIC" on
  250. drive C, you would type at the prompt: C:\MUSIC\DMP.EXE.  If you do not
  251. specify an extension, ModMenu will assume that the extension is ".EXE" and
  252. add it in FOR you.  You may also enter any parameters you want passed on
  253. to your module player here, separate each parameter with a space. Again,
  254. you may indicate any path as long as it is 28 characters or less.  If you
  255. have a path that is longer than 28 characters, see section "THE MM.CFG FILE"
  256. below.
  257.  
  258.     NOTE:  The following applies to BOTH the ExePath and the ModPath:
  259.     =====
  260.            You DO NOT need to enter the drive letter of the directory
  261.            that your player or modules are in if the drive is the same
  262.            as the CURRENT drive.  For example, if you started ModMenu
  263.            on drive C: (the current drive), then:
  264.  
  265.            C:\MUSIC\<blah,blah> is the same as \MUSIC\<blah,blah>
  266.  
  267.     At the "ModPath" prompt, enter the path to your modules.  For example,
  268. if your modules (.MOD files) are located in a subdirectory called "MOD"
  269. under the directory "MUSIC" on drive C, you would type this at the prompt:
  270. C:\MUSIC\MOD\.  Note the "\" at the end of the path, it is required by
  271. ModMenu, but if you do not type it in, ModMenu will do it for you.  The
  272. limit for this field is also 28 characters, if you have a path that is
  273. longer than 28 characters, see section "THE MM.CFG FILE" below.
  274.  
  275.     At the "Delay" prompt, enter a value between 1 and 9 for the delay of
  276. the control panel that appears when you play multiple files.  You can also
  277. use the left and right arrow keys here to either decrease (left) or increase
  278. (right) the value. This value controls how long the control panel remains on
  279. the screen before going on to with the next song.  This gives you the chance
  280. to abort, repeat, skip songs, etc.  Enter 1 (one) for virtually no delay. The
  281. greater the value, the longer the delay (9 being the longest).
  282.  
  283.  
  284. PASSING PARAMETERS TO THE PLAYER:
  285. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  286.     If your module player accepts parameters on the command line and you
  287. wish to make use of them, enter the parameter(s) AFTER the EXE name of
  288. your module player at the "ExePath" prompt.  For example, if you have
  289. DMP v3.0 and wanted to specify looping, you would enter this at the "ExePath"
  290. prompt: 
  291.  
  292. ExePath: C:\MUSIC\DMP.EXE /L
  293.  
  294. If you want, you can also modify the MM.CFG file with a text editor and
  295. insert the parameter(s) on the 4th (fourth) line.  The first character
  296. of this line MUST BE A SPACE; enter the first parameter after
  297. this space. If you need more than one parameter, MAKE SURE each is separated
  298. by a space.  See section "THE MM.CFG FILE" below for examples and details.
  299.  
  300.                         
  301. COMMAND KEYS IN MODMENU:
  302. ^^^^^^^^^^^^^^^^^^^^^^^^
  303. NOTE:  A tagged file will be indicated by black arrows on either side of the
  304. =====  file name.
  305.  
  306. Up Arrow & Down Arrow :  Move highlight bar up or down.
  307.  
  308. Page Up & Page Down   :  Move one screen up or down.
  309.  
  310. Esc or E              :  Exit ModMenu and return to DOS.
  311.  
  312. Home & End            :  Move to the first or last file.
  313.  
  314. Space Bar             :  Tag/untag highlighted file.
  315.  
  316. Enter                 :  Play highlighted file or tagged files.
  317.  
  318. C                     :  To configure ModMenu.
  319.  
  320. T                     :  Tag all files in directory.                    
  321.  
  322. U                     :  Untag any or all tagged files.
  323.  
  324. F                     :  Find a file; type the first few characters and
  325.                          ModMenu will attempt to find a matching file
  326.                          name starting with these characters.
  327.  
  328. R                     :  Toggle random playing of tagged files on or off.
  329.  
  330. L                     :  Toggle loop (continous play) mode on or off.
  331.  
  332.  
  333. PLAYING MULTIPLE FILES:
  334. ^^^^^^^^^^^^^^^^^^^^^^^
  335. To play multiple files, use the Space Bar to tag the songs you want.  Press
  336. "T" to tag all songs.  Hit "Enter" to start playing any (or all) tagged songs.
  337. In between songs, a control panel will appear, you may do the following:
  338.  
  339.   ■ Press left to go back one (to repeat a song) or several songs.
  340.   ■ Press right to skip forward one or more songs.
  341.   ■ Press "P" to pause.
  342.   ■ Press Escape to abort and return to main menu.
  343.  
  344.  
  345. PLAYING FILES RANDOMLY:
  346. ^^^^^^^^^^^^^^^^^^^^^^^
  347. To play files randomly, use the Space Bar to tag the songs you want played
  348. randomly.  Press "T" to tag all songs for random play.  Press "R" to turn
  349. the Random toggle on (indicated by a check mark).  Hit "Enter" to start
  350. playing any or all tagged songs randomly.  In between random songs, a control
  351. panel will appear, you may do the following:
  352.  
  353.   ■ Press left to repeat last song.
  354.   ■ Press right to skip forward one or more songs.
  355.   ■ Press "P" to pause.
  356.   ■ Press Escape to abort and return to main menu.
  357.  
  358.  
  359.  
  360. THE MM.CFG (ModMenu Configuration) FILE:
  361. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  362.     This file should be located in the same directory from which ModMenu was
  363. started.  If ModMenu does not find it, you will be prompted to enter new
  364. values and ModMenu will then create a new configuration file and save it in
  365. the current directory.  You can edit this file in any text editor.  ModMenu
  366. will only read the first 5 (five) lines of this file.
  367.     
  368.     Although you can only enter up to 28 characters when prompted for the
  369. paths within ModMenu, you may modify the configuration file with a text editor
  370. and enter the COMPLETE path to your player and/or modules.  ModMenu, however,
  371. will only display the first 28 characters of your path(s).  The length for the
  372. description of the player can NOT be changed, it is set at 28.
  373.  
  374. The format of the configuration file (MM.CFG) is as follows:
  375.  
  376. 1st line:  Path and executable file to module player.
  377. 2nd line:  Path to the directory in which your modules reside.
  378. 3rd line:  Description of your module player.
  379. 4th line:  Parameters passed on to your module player.
  380. 5th line:  Value for the delay of the control panel between multiple play.
  381.            Valid values: 1 to 9; 1 for virtually no delay, 9 for the longest
  382.            delay.
  383.  
  384. IMPORTANT!!!
  385. ^^^^^^^^^^^^
  386. On the fourth line of the configuration file, you may enter parameters
  387. that you want passed on to the module player.  The first character of
  388. this line SHOULD ALWAYS BE A SPACE; enter the first parameter after this
  389. space.  If you need more than one parameter, MAKE SURE each parameter
  390. (including the dash or slash) is separated by a space.  SEE EXAMPLE BELOW!
  391.  
  392.  
  393. Example configuration file:
  394. ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  395.  
  396. C:\MUSIC\DMP.EXE
  397. C:\MUSIC\MOD\
  398. Dual Module Player v3.0
  399.  -L -something -something else
  400. 5
  401.  
  402.  
  403.  
  404. FUTURE PLANS FOR ENHANCEMENT:
  405. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  406. The following options will be added to the ModMenu package for future
  407. releases.
  408.  
  409.       Complete mouse support.
  410.     
  411.       Full use of extended (XMS) and expanded (EMS) memory.
  412.  
  413. Any and all other suggestions are always welcome.
  414.  
  415.  
  416.  
  417. CONTACTING US:
  418. ~~~~~~~~~~~~~~
  419. We can be reached via postal mail at the following address:
  420.  
  421. Apex Software
  422. ATTN: <see ATTENTION below>
  423. 17300 Flame Tree Circle
  424. Fountain Valley, CA 92708
  425.  
  426. ATTENTION:  If you are...
  427. ~~~~~~~~~~
  428.          - reporting a bug, include the bug report form and write:
  429.               
  430.            ATTN: Software Bugs
  431.  
  432.          - sending comments/suggestions/questions, write:
  433.               
  434.            ATTN: Customer Support
  435.             
  436.          - sending a registration: include the registration form, and the
  437.            color configuration form if you want custom colors, and write:
  438.               
  439.            ATTN: Software Registration
  440.  
  441.  
  442. We can also be reached on Prodigy Interactive Personal Service; the identifi-
  443. cation number is:  FVPC20A.
  444.  
  445. We can be reached via electronic mail (E-mail) at the following bulletin
  446. boards.  Approximate response time:  2-5 days.
  447.  
  448. NOTE:  Please DO NOT place any orders on these bulletin boards.  However any
  449. ^^^^^  questions, comments, suggestions, and bug reports are welcome. Address
  450.        messages to:  Apex Software.
  451.  
  452.  
  453. Chips+ Connection:  
  454. ==================
  455. Nodes 1-5 : (714) 556-3208 USRobotics HST DS V.42/V.42bis/V.32/V.32bis
  456. Nodes 6-7 : (714) 760-3265 USRobotics HST DS V.42/V.42bis/V.32/V.32bis
  457. Nodes 8-11: (714) 556-3207 USRobotics HST DS V.FC/V.42/V.42bis/V.32/V.32bis
  458.  
  459. NOTE:  Nodes 1 through 7 support baud rates of 2400 up to 16,800.
  460.        Nodes 8 through 11 support baud rates of 9600 up to 28,800.
  461.  
  462. North Orange County Computer Club (NOCCC):
  463. ==========================================
  464. Node 1-3  : (714) 730-6743 ZyXel V.42/V.42bis/V.32/V.32bis
  465. Node 4-5  : (714) 730-5739 USRobotics HST DS V.42/V.42bis/V.32/V.32bis
  466.  
  467. NOTE:  All nodes support baud rates of 2400 up to 14,400.
  468.  
  469.  
  470.  
  471. DocRev: 08/23/94
  472.  
  473. [End Of MM.DOC]
  474.